************
INTRODUCTION
************

This file describes how to set up and use the java wrapper code with Melissa DATA's Address Object.


*************
PREREQUISITES
*************

To make use of the Address Object java wrapper you will need:

* An installation of a Java Developer's Kit 1.4.2 or later or an equivalent product.

* The Melissa DATA Address Object library and data files installed.

	Library = mdAddr.dll
	Data Files = mdAddr.dat, mdAddr.nat, mdAddr.str, mdAddr.lic, mdAddr.sfx

  These files are installed automatically if you run setup.exe from the root of the DQ Suite DVD. 
  You will need to know the location of these files.

  
**********************
Wrapper compatibility
**********************

If the provided pre-compiled wrappers are not compatible with your environment, the necessary files for compilation can be found in the 'interfaces' folder of the object's main directory.



*************
Installation
*************

Copy the entire folder that contains this readme.txt into a local directory on your computer.


*****
Setup
*****

Open CreateJarFile.bat in wordpad. Put the path to your Java bin directory to the Java_Dir variable. 

	Example: set JAVA_DIR=c:\Program Files\Java\jdk1.6.0_01\bin

Open RunSample.bat in wordpad. Put the path to your Java bin directory to the the Java_Dir variable.

	Example: set JAVA_DIR=c:\Program Files\Java\jdk1.6.0_01\bin


Open AddressSample.java, and set the Address Object License string that you receive from your Melissa Data sales representative
as well as the directory of the Address Object data files.
  
		public static String the_license = "demo";
  		public static String datafile_dir = "C:\\Program Files\\Melissa Data\\DQT\\Data";


*******************
Running the Scripts
*******************

Double Click on CreateJarFile.bat. This should create a file called mdAddr.jar. This file must be 
created successfully to use the Java wrapper.

Copy mdAddr.dll into the directory with RunSample.bat and Double Click on RunSample.bat. 
This will compile AddressSample.java and run the sample program. 


***********
Sample Code
***********

AddressSample.java contains sample code for using Address Object. If you make changes to AddressSample.java, 
you must execute RunSample.bat again to recompile the code.

*******
Updates
*******

The wrapper normally does not need to be rebuilt for DQ Suite updates. They are the connection between 
Address Object (mdAddr.dll) and the java client code. As long as the method naming changes or deletions in 
Address Object, the wrapper does not need to be changed. For newly added methods, the wrapper also does not 
need to be rebuilt unless you want to use the new methods. 

****
Note
****

The source code and a bat script to compile mdAddrJavaWrapper.dll is supplied in the Source directory. 
Since mdAddrJavaWrapper.dll is already supplied, you do not need to use this unless you have to 
recompile mdAddrJavaWrapper.dll. Instructions to compile are in CreateDll.bat and the readme.txt in the 
Source folder. Please read them before executing the bat file. 



COPYRIGHT NOTICE

(C) 2008 Melissa Data Corporation. All rights reserved.
